home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / gfx / conv / amigajpegv4.lha / jpeg-v4 / man / djpeg.man < prev   
Text File  |  1993-01-10  |  9KB  |  196 lines
  1.  
  2.  
  3.  
  4.  DDDDJJJJPPPPEEEEGGGG((((1111))))                                                           DDDDJJJJPPPPEEEEGGGG((((1111))))
  5.                                 2222 AAAAuuuugggguuuusssstttt 1111999999992222
  6.  
  7.  
  8.  
  9.  NNNNAAAAMMMMEEEE
  10.       djpeg - decompress a JPEG file to an image file
  11.  
  12.  SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.       ddddjjjjppppeeeegggg [ ----ccccoooolllloooorrrrssss _N ] [ ----ggggiiiiffff ] [ ----ppppnnnnmmmm ] [ ----rrrrlllleeee ] [ ----ttttaaaarrrrggggaaaa ] [
  14.       ----bbbblllloooocccckkkkssssmmmmooooooootttthhhh ] [ ----ggggrrrraaaayyyyssssccccaaaalllleeee ] [ ----mmmmaaaaxxxxmmmmeeeemmmmoooorrrryyyy _N ] [ ----nnnnooooddddiiiitttthhhheeeerrrr ] [ ----oooonnnneeeeppppaaaassssssss
  15.       ] [ ----vvvveeeerrrrbbbboooosssseeee ] [ ----ddddeeeebbbbuuuugggg ] [ _f_i_l_e_n_a_m_e ]
  16.  
  17.  DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.       ddddjjjjppppeeeegggg decompresses the named JPEG file, or the standard input if no
  19.       file is named, and produces an image file on the standard output.
  20.       PBMPLUS (PPM/PGM), GIF, Targa, or RLE (Utah Raster Toolkit) output
  21.       format can be selected.  (RLE is supported only if the URT library is
  22.       available.)
  23.  
  24.  OOOOPPPPTTTTIIIIOOOONNNNSSSS
  25.       All switch names may be abbreviated; for example, ----ggggrrrraaaayyyyssssccccaaaalllleeee may be
  26.       written ----ggggrrrraaaayyyy or ----ggggrrrr.  Most of the "basic" switches can be abbreviated
  27.       to as little as one letter.  Upper and lower case are equivalent (thus
  28.       ----GGGGIIIIFFFF is the same as ----ggggiiiiffff).  British spellings are also accepted (e.g.,
  29.       ----ggggrrrreeeeyyyyssssccccaaaalllleeee), though for brevity these are not mentioned below.
  30.  
  31.       The basic switches are:
  32.  
  33.       ----ccccoooolllloooorrrrssss _N
  34.            Reduce image to at most N colors.  This reduces the number of
  35.            colors used in the output image, so that it can be displayed on a
  36.            colormapped display or stored in a colormapped file format.  For
  37.            example, if you have an 8-bit display, you'd need to reduce to
  38.            256 or fewer colors.
  39.  
  40.       ----qqqquuuuaaaannnnttttiiiizzzzeeee _N
  41.            Same as ----ccccoooolllloooorrrrssss.  ----ccccoooolllloooorrrrssss is the recommended name, ----qqqquuuuaaaannnnttttiiiizzzzeeee is
  42.            provided only for backwards compatibility.
  43.  
  44.       ----ggggiiiiffff Select GIF output format.  Since GIF does not support more than
  45.            256 colors, ----ccccoooolllloooorrrrssss 222255556666 is assumed (unless you specify a smaller
  46.            number of colors).
  47.  
  48.       ----ppppnnnnmmmm Select PBMPLUS (PPM/PGM) output format (this is the default
  49.            format).  PGM is emitted if the JPEG file is gray-scale or if
  50.            ----ggggrrrraaaayyyyssssccccaaaalllleeee is specified; otherwise PPM is emitted.
  51.  
  52.       ----rrrrlllleeee Select RLE output format.  (Requires URT library.)
  53.  
  54.       ----ttttaaaarrrrggggaaaa
  55.            Select Targa output format.  Gray-scale format is emitted if the
  56.            JPEG file is gray-scale or if ----ggggrrrraaaayyyyssssccccaaaalllleeee is specified; otherwise,
  57.            colormapped format is emitted if ----ccccoooolllloooorrrrssss is specified; otherwise,
  58.            24-bit full-color format is emitted.
  60.  
  61.  
  62.                                     - 1 -       Formatted:  January 10, 1993
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  DDDDJJJJPPPPEEEEGGGG((((1111))))                                                           DDDDJJJJPPPPEEEEGGGG((((1111))))
  70.                                 2222 AAAAuuuugggguuuusssstttt 1111999999992222
  71.  
  72.  
  73.  
  74.       Switches for advanced users:
  75.  
  76.       ----bbbblllloooocccckkkkssssmmmmooooooootttthhhh
  77.            Perform cross-block smoothing.  This is quite memory-intensive
  78.            and only seems to improve the image at very low quality settings
  79.            (----qqqquuuuaaaalllliiiittttyyyy 10 to 20 or so).  At normal quality settings it may
  80.            make the image worse.
  81.  
  82.       ----ggggrrrraaaayyyyssssccccaaaalllleeee
  83.            Force gray-scale output even if JPEG file is color.  Useful for
  84.            viewing on monochrome displays.
  85.  
  86.       ----mmmmaaaaxxxxmmmmeeeemmmmoooorrrryyyy _N
  87.            Set limit for amount of memory to use in processing large images.
  88.            Value is in thousands of bytes, or millions of bytes if "M" is
  89.            attached to the number.  For example, ----mmmmaaaaxxxx 4444mmmm selects 4000000
  90.            bytes.  If more space is needed, temporary files will be used.
  91.  
  92.       ----nnnnooooddddiiiitttthhhheeeerrrr
  93.            Do not use dithering in color quantization.  By default, Floyd-
  94.            Steinberg dithering is applied when quantizing colors, but on
  95.            some images dithering may result in objectionable "graininess".
  96.            If that happens, you can turn off dithering with ----nnnnooooddddiiiitttthhhheeeerrrr.
  97.            ----nnnnooooddddiiiitttthhhheeeerrrr is ignored unless you also say ----ccccoooolllloooorrrrssss _N.
  98.  
  99.       ----oooonnnneeeeppppaaaassssssss
  100.            Use one-pass instead of two-pass color quantization.  The one-
  101.            pass method is faster and needs less memory, but it produces a
  102.            lower-quality image.  ----oooonnnneeeeppppaaaassssssss is ignored unless you also say
  103.            ----ccccoooolllloooorrrrssss _N.  Also, the one-pass method is always used for gray-
  104.            scale output (the two-pass method is no improvement then).
  105.  
  106.       ----vvvveeeerrrrbbbboooosssseeee
  107.            Enable debug printout.  More ----vvvv's give more output.  Also,
  108.            version information is printed at startup.
  109.  
  110.       ----ddddeeeebbbbuuuugggg
  111.            Same as ----vvvveeeerrrrbbbboooosssseeee.
  112.  
  113.  EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  114.       This example decompresses the JPEG file foo.jpg, automatically
  115.       quantizes to 256 colors, and saves the output in GIF format in
  116.       foo.gif:
  117.  
  118.            ddddjjjjppppeeeegggg ----ggggiiiiffff _f_o_o._j_p_g >>>> _f_o_o._g_i_f
  119.  
  120.  EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  121.       JJJJPPPPEEEEGGGGMMMMEEEEMMMM
  122.            If this environment variable is set, its value is the default
  123.            memory limit.  The value is specified as described for the
  124.            ----mmmmaaaaxxxxmmmmeeeemmmmoooorrrryyyy switch.  JJJJPPPPEEEEGGGGMMMMEEEEMMMM overrides the default value specified
  125.  
  126.  
  127.                                     - 2 -       Formatted:  January 10, 1993
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  DDDDJJJJPPPPEEEEGGGG((((1111))))                                                           DDDDJJJJPPPPEEEEGGGG((((1111))))
  135.                                 2222 AAAAuuuugggguuuusssstttt 1111999999992222
  136.  
  137.  
  138.  
  139.            when the program was compiled, and itself is overridden by an
  140.            explicit ----mmmmaaaaxxxxmmmmeeeemmmmoooorrrryyyy.
  141.  
  142.  SSSSEEEEEEEE AAAALLLLSSSSOOOO
  143.       ccccjjjjppppeeeegggg(1)
  144.       ppppppppmmmm(5), ppppggggmmmm(5)
  145.       Wallace, Gregory K.  "The JPEG Still Picture Compression Standard",
  146.       Communications of the ACM, April 1991 (vol. 34, no. 4), pp. 30-44.
  147.  
  148.  AAAAUUUUTTTTHHHHOOOORRRR
  149.       Independent JPEG Group
  150.  
  151.  BBBBUUUUGGGGSSSS
  152.       Arithmetic coding is not supported for legal reasons.
  153.  
  154.       Still not as fast as we'd like.
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  190.  
  191.  
  192.                                     - 3 -       Formatted:  January 10, 1993
  193.  
  194.  
  195.  
  196.